package com.example.controller;

import com.example.common.R;
import com.mybatisflex.core.paginate.Page;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import jakarta.annotation.Resource;
import com.example.entity.StudentInfo;
import com.example.service.StudentInfoService;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import java.io.Serializable;
import java.util.List;

/**
 * 学生信息 控制层。
 *
 * @author sunfayun
 * @since 2023-10-24
 */
@RestController
@Tag(name = "学生信息接口")
@RequestMapping("/studentInfo")
public class StudentInfoController {

    @Resource
    private StudentInfoService studentInfoService;

    /**
     * 添加学生信息。
     *
     * @param studentInfo 学生信息
     * @return {@code true} 添加成功，{@code false} 添加失败
     */
    @PostMapping("save")
    @Operation(summary="保存学生信息", description="保存学生信息")
    public R<Boolean> save(@RequestBody @Parameter(description="学生信息")StudentInfo studentInfo) {
        return R.ok(studentInfoService.save(studentInfo));
    }

    /**
     * 根据主键删除学生信息。
     *
     * @param id 主键
     * @return {@code true} 删除成功，{@code false} 删除失败
     */
    @DeleteMapping("remove/{id}")
    @Operation(summary="根据主键删除学生信息", description="根据主键删除学生信息")
    public R<Boolean> remove(@PathVariable @Parameter(description="学生信息主键")Long id) {
        return R.ok(studentInfoService.removeById(id));
    }

    /**
     * 根据主键更新学生信息。
     *
     * @param studentInfo 学生信息
     * @return {@code true} 更新成功，{@code false} 更新失败
     */
    @PutMapping("update")
    @Operation(summary="根据主键更新学生信息", description="根据主键更新学生信息")
    public R<Boolean> update(@RequestBody @Parameter(description="学生信息")StudentInfo studentInfo) {
        return R.ok(studentInfoService.updateById(studentInfo));
    }

    /**
     * 查询所有学生信息。
     *
     * @return 所有数据
     */
    @GetMapping("list")
    @Operation(summary="查询所有学生信息", description="查询所有学生信息")
    public R<List<StudentInfo>> list() {
        return R.ok(studentInfoService.list());
    }

    /**
     * 根据学生信息主键获取详细信息。
     *
     * @param id 学生信息主键
     * @return 学生信息详情
     */
    @GetMapping("getInfo/{id}")
    @Operation(summary="根据主键获取学生信息", description="根据主键获取学生信息")
    public R<StudentInfo> getInfo(@PathVariable Serializable id) {
        return R.ok(studentInfoService.getById(id));
    }

    /**
     * 分页查询学生信息。
     *
     * @param page 分页对象
     * @return 分页对象
     */
    @GetMapping("page")
    @Operation(summary="分页查询学生信息", description="分页查询学生信息")
    public R<Page<StudentInfo>> page(@Parameter(description="分页信息")Page<StudentInfo> page) {
        return R.ok(studentInfoService.page(page));
    }

}
